Skip to main content
Version: 5.0.x {nightly}

Battery limiter - external

Input values to this limiter are not measured by the controller. The application must provide these values. This is usually done by CAN messages. For more information check the application-specific documentation.

info

Next variables are located in the folder /driver/limiter.

note
  • Current direction from the battery to the motor is considered as positive (motoring, battery is being discharged).
  • Current direction from the motor to the battery is considered as negative (generating, battery is being charged).
  • In some of the applications, some of the hereby parameters may be set as "volatile", rendering them as not being user-settable and not saved to the FLASH memory. This is because, they are set from the user application. Example: ppos in the LYNX is set individually per each power_map.
  • To disable a limiter, set the limiter setting to zero.

Parameters​

Battery temperature limitation​

This limiter works with an externally acquired battery temperature. There is no dedicated hardware input in the controller. Each application may implemented an application-specific method (usually, a dedicated GPIO for reading the temperature or, by acquiring data from a BMS)

tip

E.g. If you are using the LYNX application with siliXcon BMS, the properly configured BMS automatically adjusts controller power to prevent any damage to the battery.

btemp

btempmaxhi [°C]​

At this temperature and over, the power is 100% limited.

btempmaxlo [°C]​

At this temperature, the power starts to limit proportionally as the temperature is further increased.

btempminlo [°C]​

At this temperature, the power starts to limit proportionally as the temperature is further decreased.

danger

Li-ion batteries do not like low temperatures, especially not charging at low temperatures.

btempminhi [°C]​

At this temperature and below, the power is 100% limited.

Battery cell voltage limitation​

This limiter works with an externally acquired battery minimum and maximum cell voltage. There is no dedicated hardware input in the controller. Each application may implemented an application-specific method (usually, by acquiring data from a BMS)

tip

If you are using LYNX application with siliXcon BMS, the properly configured BMS automatically adjusts controller power to prevent any damage to the battery.

bcellmax [V]​

Maximum voltage of the battery cell with the highest voltage.

bcellmin [V]​

Minimum voltage of the battery cell with the lowest voltage.

bcellgain [-]​

This parameter sets the dynamic response. The higher value, the quicker response (negative or positive), but this may also lead to oscilation in this limiter. Lower values will lead to smoother response.